Skip to main content
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

XM Directory Respondent Funnel


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


About XM Directory Respondent Funnel

XM Directory users can visualize CX program metrics such as email open rate and survey response rate with the use of the Respondent Funnel. The Respondent Funnel allows XM Directory distribution and contact metrics, transactional data, Embedded Data, and even contact import automation failures to be uploaded into CX Dashboards for transparency with all your key stakeholders.

Qtip: Any user with the Manage Directories and Use Directory Data for Dashboards permissions will be able to enable the Respondent Funnel.
Qtip: You can include one Respondent Funnel per dashboard.
Qtip: Because the respondent funnel uses distribution data as a data source instead of response data, deleted responses will continue to appear in the Respondent Funnel. You can use filters to refine which responses you would like to be displayed with the Respondent Funnel.

Enabling Respondent Funnels for a User

Once Respondent Funnels are enabled for a brand, each user who wants to use the feature to build dashboards will have to complete the steps below.

Enabling the User Permission

Enable the user permission under Contacts called Use Directory Data for Dashboards. Make sure you can also access and manage the directory.

Contacts section of user permissions. Use Respondent Funnel is last in Account Permissions list

Enabling the Dashboard

Before following these steps, make sure you are in the account you’d like to enable this feature for. If your brand has multiple directories, you must also make sure you are in the desired directory. You can enable the Respondent Funnel for multiple directories, but you must turn it on individually for each directory.

Qtip: Any user with the Manage Directories and Use Directory Data for Dashboards permissions will be able to enable the Respondent Funnel.
  1. Go to your directory by clicking Directories.
    clicking the navigation menu in the top left and clicking Directories
  2. Select Directory Settings.
  3. Select Dashboard setup.
  4. Click Enable Dashboard.
Qtip: The Enable Dashboard button disappears once the user has permission to start using Respondent Funnels in their account’s CX Dashboards.

Mapping Funnel Data

Before you can start building a dashboard about your XM Directory, you’ll need to map your funnel data to your dashboard. Your funnel data may be mapped into a dashboard with up to 20 other survey data sources. Note that Respondent Funnel records event data as events occur, and will not update if contact data changes or is deleted in the future. If you delete distributions or contacts, data from these deleted fields will still be present in Respondent Funnel.

In order to map your funnel data to the dashboard, follow the steps below.

Attention: When the most recent timestamp of a respondent funnel event is over 13 months old, the event will no longer be displayed in the dashboard once the dashboard is reindexed. For example, if a survey is started in September 2019 and finished in October 2019, the most recent timestamp for this funnel event would be October 2019. This event will then stop appearing in your dashboard if it is reindexed in December of 2020.
Qtip: Depending on size, dashboards containing a Respondent Funnel source may only be able to be recached once every 24 hours. Recaching is triggered whenever fields in the Dashboard Data are changed, added, or removed. We recommend making all of your Dashboard Data modifications at once, when possible.
Qtip: Adding a Respondent Funnel source to your dashboard will cause all record exports (CSV/TSV) from the dashboard to process slower than before. Additionally, there may be up to 1 hour of delay between when a record displays in a dashboard and when it’s available in CSV exports.
  1. In the dashboard data section of your dashboard, click Add dataset.
    creating a new dataset
  2. Click Create dataset.
    creating a new dataset
  3. Name the dataset.
    giving the dataset a name

    Qtip: The respondent funnel can be used in both data mapper and data model type datasets.
  4. Click Create dataset.
  5. Click Add Source.adding the directory data as a source
  6. Hover over Directories and select the funnel data for the directory you want to map.
    Qtip: If you have multiple directories, you will have multiple options here, provided you have enabled the respondent funnel on each of these directories.
    Qtip: If you recently enabled the Respondent Funnel for your directory, this funnel data may not appear in the menu for some time. This step may take several minutes to two hours.
  7. Deselect any fields you do not want to include.
    choosing fields
  8. Click Add.

Attention: New distribution events do not immediately appear in the dashboard and may take 24 hours to be included in reports.

Qtip: If you want to report on response rate or completion rate, you will need to create custom metrics in your dashboard. See Response Rate and Completion Rate for more information.

Adding Respondent Funnel as a Secondary Data Source

If you add the respondent funnel to an existing dashboard with an existing data mapper dataset, you will need to add and map your respondent funnel fields manually. For an overview of the fields to map, see Default Fields.

If you attempt to use the respondent funnel dashboard template, you will see the below error message.an error message when using the directory template
To resolve this message, you must manually edit each widget in the template and reselect the respondent funnel fields. You can avoid this message by having your respondent funnel data be the primary data source in the dashboard.

Response Rate and Completion Rate

Before you can report on response rate and completion rate in your dashboard, you will need to add 2 custom metrics.

Response Rate

  1. In the dashboard settings, click on the Custom metrics page.creating a response rate custom metric
  2. Click Add custom metric.
  3. Call it “Response Rate.”
  4. Add the following equation: (Count) / ( (Count) – (Count) ).
  5. Click the numerator.
    clicking the numerator and filtering it
  6. Go to the Filters section.
  7. Click Add Filter.
  8. Hover over Number and select Survey Finished.
    choosing survey started
  9. Use the slider to select 1 to 1.
    filtering for survey finished
  10. Click Save.
  11. Click the first metric in the denominator.
    filtering the first number in the denominator
  12. Go to the Filters section.
  13. Click Add Filter.
  14. Hover over Number and select Email Sent.
    filtering for email sent
  15. Use the slider to select 1 to 1.
    filtering for email sent
  16. Click Save.
  17. Click the second metric in the denominator.
    filtering the second metric in the denominator
  18. Go to the Filters section.
  19. Click Add Filter.
  20. Hover over Number and select Email Bounced.
    filtering for email bounced
  21. Use the slider to select 1 to 1.
    filtering for email bounced and saving
  22. Click Save.
  23. Make sure to Save your changes after your metrics are fully built.

Completion Rate

  1. Similarly, create a second custom metric and call it “Completion Rate.”
    creating a custom metric called completion rate
  2. Add the following equation: (Count) / (Count).
  3. Click the numerator.
    filtering the numerator
  4. Go to the Filters section.
  5. Click Add Filter.
  6. Hover over Number and select Survey Finished.
    filtering for survey finished
  7. Use the slider to select 1 to 1.
    filtering for survey finished
  8. Click Save.
  9. Filter the denominator so it includes only responses where Survey Started.
    filtering the denominator for survey started and then saving
  10. Click Save.

Example Custom Metrics

Custom metrics help to report on respondent funnel data. There are a few common custom metrics that are useful for analyzing data:

  1. Emails Succeeded: (Sum Email Sent) – (Sum Email Bounced)
  2. Emails Opened: (Sum Emails Opened) / (Sum Email Sent) – (Sum Email Bounced)
  3. Opt Out Rate: (Sum Unsubscribed) / (Sum Email Sent) – (Sum Email Bounced)
  4. Bounce Rate: (Sum Email Bounced) / (Sum Email Sent)
Qtip: For information on creating custom metrics, see Custom Metrics.

Loading Historical Data

Once a Respondent Funnel is generated, you will automatically be able to report on all data after the feature was enabled for your brand. Loading historical data allows you also to report on data from previous distributions that was collected before the Respondent Funnel was enabled.

Qtip: Historical data on opt ins and opt outs cannot be backfilled. That means information like Contact List Subscribed / Unsubscribed, Contact Directory Subscribed / Unsubscribed, and related time stamps will not be included in historical data.
Attention: Loading historical data is only used to load data from before the Respondent Funnel was activated in the Directory. It cannot be used to backfill embedded data or transaction data fields for existing funnel records.
Attention: Historical data can only be loaded once for a directory. If you change any existing fields or enable additional fields, these fields will only be available in new funnel data going forward.
  1. Navigate to the respondent funnel you enabled.
  2. Select the checkbox next to Load historical data for the fields defined above.
  3. Click Load historical data.
    Attention: One custom transaction or embedded data field must be added to the configuration before you will be able to load historical data. The option to load historical data will not appear for Respondent Funnels which were created over 13 months ago. This is because all data from that period is already stored and there is nothing additional to load in.
  4. The status of the historical data load will be displayed within the respondent funnel window.
Attention: The loading process may take a long time to complete depending on the amount of data added to your respondent funnel. The loading status will update once all historical data is loaded.successful respondent funnel historical data load message

Default Fields

Special Considerations for Fields

  • Emails skipped due to Contact Frequency Rules and events related to Contact Import Automations are not automatically tracked for Respondent Funnels created after December 1, 2022. Please contact Qualtrics Support if you would like to enable tracking for these fields in your Respondent Funnel.
  • When making email distribution calculations (e.g., Email Bounced, Email Opened, Email Sent), the Respondent Funnel will consider all email types. To limit what emails are used in these calculations, add a filter for the Distribution Category field and filter by your desired email type. More information about the Distribution Category field can be found in the table below.
  • To view data for a specific survey, you’ll need to add a dashboard filter based on Survey ID. We recommend recoding your Survey IDs to their corresponding survey name to make filtering easier.
  • Survey Finished and Survey Partial Recorded are separate fields within the Respondent Funnel. Survey Finished only includes complete responses and does not include partial responses.
  • Email Sent and Email Blocked are separate fields within the Respondent Funnel. This provides a more detailed record of what happened with each sent distribution.

Default Fields Overview

Many fields will be mapped into your dashboard by default. The Field Type listed here is what fits the field the best; you may need to recode fields somewhat after mapping. See the tables below for all the fields that will be mapped in by default.

For Number Sets, the value will be 0 to imply the opposite of the description occurred. Remember Number Sets can be recoded to Text Sets to add more intuitive labelling.

Attention: While all default fields will be automatically mapped to your dashboard, individual records typically contain values for only a subset. Depending on your directory use, you may see some fields with no values in your dashboard records.

Available Email Fields

Field Name Field Type Description
Bounce Type Text Set If your message bounced, indicates if it was a hard of soft bounce.
Email Blocked Number Set 1 if the email was a duplicate. Duplicate emails are the same message, subject line, and recipient as another email sent within a 12-hour window.
Email Blocked Time Date DateTime that the email was blocked as a duplicate.
Email Bounced Number Set 1 if the sent email bounced. Bounced emails left Qualtrics, did not reach the recipient’s inbox, and were returned to Qualtrics servers.
Email Bounced Time Date DateTime that the email was blocked due to being a duplicate.
Email Duplicate Number Set An older field that is no longer used.
Email Duplicate Time Date DateTime that an email was determined a duplicate and not sent.
Email Failed Number Set 1 if the email was attempted but failed to send. There are many reasons why emails can fail. The most common reason is an incorrectly formatted email address.
Email Failed Time Date DateTime that an email failed to send.
Email Opened Number Set 1 if the email was opened after being sent out.
Email Opened Time Date DateTime that an email was opened by the recipient.
Email Sent Number Set 1 if Qualtrics sent the email. Email Sent includes email survey invitations and reminder and thank you emails, as well as SMS invitations.
Email Sent Time Date DateTime that an email successfully sent.
Email Skipped Number Set 1 if this email was not sent due to contact frequency rules. This field is no longer tracked for funnels enabled on or after December 1, 2022.
Email Skipped Time Date DateTime that an email was not sent due to Contact Frequency rules. This field is no longer tracked for funnels enabled on or after December 1, 2022.
Invalid Email Format Number Set 1 if this row had an invalid email address format.
Invalid Email Format Time Date DateTime the email format was determined invalid.

Available Distribution Fields

Field Name Field Type Description
Distribution Category Text Set Indicates the category of email that sent. Values include Invite, Thank You, Reminder, and Other. You can add this field as a dashboard filter to easily allow you to filter based on different categories of emails.
Distribution Channel Text Set The method used to distribute your message. Possible values include Email, GeneratedLink, SMS, Unknown, and WhatsApp.
Distribution ID Text Set Qualtrics Distribution ID. This value will be blank if no distribution was scheduled for this transaction.
Distribution Type Text Set Indicates the type of distribution that sent. Since there are many different distribution types, there’s a large set of possible values for this field.

Available Contact Fields

Field Name Field Type Description
Contact Directory Subscribed Number Set Indicates if the contact resubscribed via the opt-out link to the directory. 1 if a contact subscribed from the link in the survey email, and 0 if a contact either does not click the opt-out link or clicks the opt-out via the distribution email. Note, this will only update if the contact subscribes via the opt-out link in their email invitation. Manually changing a contact’s subscription status will not update this field.
Contact Directory Subscribed Time Date DateTime the contact subscribed from your directory.
Contact Directory Unsubscribed Number Set Indicates whether the contact unsubscribed from the directory in response to this distribution. 1 if unsubscribed and 0 if subscribed. Note, this will only update if the contact unsubscribes via the opt-out link in their email invitation. Manually changing a contact’s subscription status will not update this field.
Contact Directory Unsubscribed Time Date DateTime the contact unsubscribed from your directory. This value will be blank if the contact is still subscribed.
Contact ID Text Value Qualtrics ID for the individual contact.
Contact List Subscribed Number Set Indicates if the contact subscribes to the list in response to this distribution. 1 if subscribed and 0 if unsubscribed. Note, this will only update if the contact resubscribes via the opt-out link in their email invitation. Manually changing a contact’s subscription status will not update this field.
Contact List Subscribed Time Date DateTime the contact subscribed to the contact list.
Contact List Unsubscribed Number Set Indicates if the contact unsubscribed from the list in response to this distribution. 1 if unsubscribed and 0 if subscribed. Note, this will only update if the contact unsubscribes via the opt-out link in their email invitation. Manually changing a contact’s subscription status will not update this field.
Contact List Unsubscribed Time Date DateTime the contact unsubscribed from the contact list. This value will be blank if the contact is still subscribed.
Directory ID Text Set Qualtrics Directory ID. This can be helpful for differentiating between multiple directories.
Email Address Text Value Email of the XM Directory contact.
External Data Reference Text Value The External Data Reference of the XM Directory contact.
First Name Text Value FirstName of the XM Directory contact.
Language Text Set Language of the XM Directory contact.
Last Name Text Value LastName of the XM Directory contact.
List ID Text Set ID of the mailing list the contact was added to.
Phone Number Text Value Phone number of the XM Directory contact.
RecipientID Text Set The contact’s ID within a specific mailing list.

Available Survey Fields

Field Name Field Type Description
Response ID Text Value Qualtrics Response ID; blank if no survey response was collected for this transaction.
Survey Finished Number Set 1 if the recipient finished the survey.
Survey Finished Time Date DateTime that the contact clicked the final “Submit” button to complete the survey.
Survey ID Text Set Qualtrics Survey ID. This value will be blank if no distribution was scheduled for this transaction.
Survey Partial Recorded Number Set 1 if the survey is an incomplete response.
Survey Partial Recorded Time Date DateTime the incomplete response was recorded.
Survey Response Screened Out Number Set 1 if the recipient was screened out of the survey.
Survey Response Screened Out Time Date DateTime that a contact was screened out of a survey.
Survey Started Number Set 1 if the recipient started the survey.
Survey Started Time Date DateTime that the contact started the survey.

Available Automation Fields

Attention: Excluding “Transaction ID”, these fields are no longer tracked by default as of December 1, 2022.
Field Name Field Type Description
Automation ID Text Value Qualtrics Automation Run ID. This field is used for custom Qualtrics implementations. If you do not have a custom solution, we recommend that you do not use this field.
Contact Create Failed Number Set 1 if the contact was unsuccessfully created as the result of an import.
Contact Create Failed Time Date DateTime that a contact was unsuccessfully created as a result of an import.
Contact Update Failed Number Set 1 if a contact failed to be updated.
Contact Update Failed Time Date DateTime that a contact was not successfully updated as a result of an import.
File Name Text Set

If present, name of the automation source file that this transaction was imported from. This is only included for unsuccessfully processed rows.

Import Row Filtered Number Set 1 if automation filtered out (did not import) this row.
Import Row Filtered Time Date DateTime that a row was filtered by the automation. This value will be blank if the row was not filtered.
Import Row Invalid Number Set 1 if automation rejected this row as invalid.
Import Row Invalid Time Date DateTime that a row was considered invalid by the automation. This value will be blank if the row was not filtered.
Import Row Success Number Set 1 if automation attempted to import a row and the import succeeded. This will only be populated if the automation imported transactional data.
Import Row Success Time Date DateTime that a row of the automation was imported into XM Directory. This will only be populated if the automation imported transactional data.
Row Number Text Value Row number in the automation source file that a given transaction was imported from. This value is not always present.
Transaction Created Number Set 1 if a transaction was created for this row.
Transaction Created Time Date DateTime that a transaction was created.
Transaction Create Failed Number Set 1 if the transaction failed.
Transaction Create Failed Time Date DateTime that a transaction failed.
Transaction ID Text Value Qualtrics Transaction ID.

Available Filter Fields

Field Name Field Type Description
Filtered Category Text Set Categories are: Duplicate, NoDistributionSettings, NoLookup, Excluded, BadDistributionDate, ImproperFormat, MissingRequiredColumns, and OverQuota.
Filtered Reason Text Set An additional clarifying message about the category will be included with categories Excluded and MissingRequiredColumns.

Miscellaneous Fields

Field Name Field Type Description
Record Date Date DateTime that the record was recorded in the Respondent Funnel fieldset. The Record Date field can be nice for some users because all the different event dates are aggregated into one place; however there is a small lag between the event’s occurrence and when it is actually recorded in the fieldset. If users want to use the most accurate information, it is best to use the event-specific fields like Email Sent Time, Email Skipped Time, etc.

 

Enabling Additional Fields

In order to report on transactional data or contact embedded data not included in the default fields, you will need to complete the following steps.

You should try to complete this step before users map their Respondent Funnel data, but it’s okay if you don’t. If data has already been mapped, then these fields can be added as new fields to Dashboard Data.

Qtip: If a contact’s directory field values are updated after the generation of the Respondent Funnel, the new values will not be reflected in the Respondent Funnel. The contact’s directory data will not update in the Respondent Funnel retroactively.
Qtip: Enabling additional fields is useful if you have an SFTP contact import automation running and want to report on the fields imported or updated in the automation.
  1. Go to your directory by selecting Directories.
    clicking the navigation menu in the top left and choosing Directories
  2. Go to the Directory Settings.
  3. Select Dashboard setup.
  4. You may need to select Change Fields.
  5. Click Add Field.
  6. Determine if the field you’re adding is transactional data or embedded data.
  7. Type the name of the field. Be careful to use the exact same spelling, capitalization, and spaces.
  8. Click Add Field to add another field.
    Attention: You can remove and add new fields as you need, but you can have no more than 50 fields at one time.
  9. Click Remove to remove a field from the Respondent Funnel.
  10. Click Enable Changes to add these fields as possible Fields mapped in a Respondent Funnel.

Please note that fields added here are not retroactive. The Respondent Funnel can only report on data fields that were configured when a distribution originally sent. If a data field is added here after a distribution has already sent, you will not be able to report on the data field for that distribution. However, you will be able to report on that data field for future distributions.

Mapping Additional Fields

If you enable additional fields before creating your dashboard, your fields will be automatically mapped for you. However, if you add these fields after creating your dashboard, you may need to manually map your fields by following the steps below.

mapping additional funnel fields

  1. In your dashboard data, click Add Field.
  2. Give your field a name.
    Qtip: When naming your field, it can help to add a prefix to the field’s name that specifies if the field is embedded data or transaction data. You can add ED_ for embedded data or TD_ for transaction fields.
    Example: If I want to map the transaction field, “Visit_Type,” then my field name in my dashboard will be “TD_Visit_Type.”
  3. If needed, adjust the field type for your mapping.
  4. Select the embedded data or transactional data field that you want to display in your dashboard.
  5. Click Save.

Using the Respondent Funnel Template

Attention: All respondent funnel functionality is compatible with data model datasets, except for page templates. Respondent funnel page templates are not compatible with the data model.

After you map your funnel data into a separate dashboard, you can technically build your dashboard however you want. This template is meant to make things easier by providing a complete report with a clean, strategic layout for your data.

Qtip: We recommend only using the template in dashboards where the respondent funnel is the primary data source.
  1. While editing your dashboard, click Add in the Pages menu.adding a page from a template
  2. Select Page from template.
  3. Select the Distribution Funnel template.
    choosing the funnel template page
  4. Select the funnel data for the directory you’d like to report on.
    Qtip: If you have multiple directories, you will have multiple options here, provided you have enabled the respondent funnel on each of these directories.
  5. Click Create.
Qtip: The response rate metric includes all sent emails. To look only at invites, add a filter for Distribution Category and filter by Invite.

Troubleshooting

Comparing Response Data and Respondent Funnel Fields

Sometimes when you’re comparing the data in your standard dashboard to your respondent funnel, you’ll notice a difference in response rates. This is to be expected, because there are some fields that don’t perfectly match between respondent funnels and survey response data.

Respondent funnel field Survey response field Description
Survey Started Time Start Date The time the respondent clicked the survey link.
No match End Date The last time the respondent accessed the survey link.
Survey Finished Time Recorded Date The time the survey was recorded, either by the client seeing the end of survey message or by their response in progress being closed by the system.
Record Date No match The time the record was created in the funnel. This is typically the time of distribution.
Survey Finished = 1

Survey Partially Finished = 0

Survey Finished = True A true “finished” survey is one where the respondent saw the end of survey message.
Survey Finished = 0

Survey Partially Finished = 1

Survey Finished = False A false survey finish is one where the respondent didn’t see the end of survey message and their response was closed by the system according to the incomplete survey options.